fix(tracing): register exporters added after initialization - #810

Dependency

• fix(tracing): trust preconfigured provider for APMPlus #813 has been squash-merged as ffbf295.
• The frozen fix(tracing): trust preconfigured provider for APMPlus #813 branch remains at 387a856 and was not modified.
• feat/exporter was rebased onto merged origin/main; the only PR increment is 018cc56dbad7e8fcf192276c7874cd3c252f194d.
• This Draft PR is now mergeable against main.

Summary

• Add BaseExporter.register(provider) to attach an exporter processor and resource attributes exactly once per provider.
• Add OpentelemetryTracer.add_exporter() so exporters enabled after tracer initialization are registered immediately.
• Route environment-driven APMPlus, CozeLoop, and TLS exporters through the registration path.
• When a global provider is already configured, retain APMPlusExporter and its meter uploader but skip only its trace processor registration. The external provider remains responsible for trace delivery.
• Avoid creating a second APMPlus exporter when one was supplied manually and ENABLE_APMPLUS=true is also set.

Root cause

Appending an exporter to tracer.exporters after the global TracerProvider had already been initialized did not attach the exporter span processor. The exporter object existed, but it could not receive or upload spans. The earlier global-provider fix also removed the APMPlus exporter object entirely, which prevented its metrics path from being retained.

Validation

• pytest -q tests/test_tracing.py tests/test_tracing_content.py — 26 passed after the rebase.
• 8-case ENABLE_APMPLUS × preconfigured provider × manual exporter unit-test matrix passed.
• Ruff 0.11.12 check and format passed.
• git diff --check passed.
• Full local pre-commit reached the gitleaks bootstrap but the machine old Go toolchain cannot parse gitleaks go 1.23.0 / toolchain directives; GitHub CI remains the authoritative full-hook check.

End-to-end matrix

The local OTLP relays observed zero duplicate (trace_id, span_id) pairs in every scenario. For each metrics-enabled scenario, the APMPlus time series had current=min=max=1, including after explicit force_flush() and process shutdown.

Known boundary

opentelemetry-instrument installs a zero-reader global MeterProvider even with OTEL_METRICS_EXPORTER=none. The #810 meter uploader cannot replace it, so the last scenario has no metrics. This is accepted for #810 and is fixed separately by #814.

Test report

• Feishu: https://bytedance.larkoffice.com/docx/FTK1dAce2oq3EDxxKDIcWJN1nAd
• Local Markdown: /Users/bytedance/go/src/code.byted.org/byteapm/docs-feng/veadk-python/VeADK_Exporter_Register_增量测试报告.md